home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2002 November
/
SGI Freeware 2002 November - Disc 2.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
catman
/
u_man
/
cat1
/
faxwatch.Z
/
faxwatch
Wrap
Text File
|
2002-07-08
|
6KB
|
132 lines
FAXWATCH(${MANNUM1_8}) FAXWATCH(${MANNUM1_8})
NNAAMMEE
faxwatch - monitor low-level _H_y_l_a_F_A_X server actions
SSYYNNOOPPSSIISS
$${{SSBBIINN}}//ffaaxxwwaattcchh [ --gg ] [ --ll ] [ --hh _h_o_s_t ] _t_r_i_g_g_e_r_-_e_x_p_r_e_s_
_s_i_o_n
DDEESSCCRRIIPPTTIIOONN
_f_a_x_w_a_t_c_h registers interest in one or more events on a
_H_y_l_a_F_A_X server and then prints subsequent event messages
to the standard output. The _f_a_x_w_a_t_c_h program is intended
mainly for testing the event distribution mechanism used
by the _H_y_l_a_F_A_X servers.
The _t_r_i_g_g_e_r_-_e_x_p_r_e_s_s_i_o_n is supplied as an argument to a
``SITE TRIGGER'' command passed to the _h_f_a_x_d(${MANNUM1_8})
The syntax for this expression is:
[<_c_l_a_s_s>['<'_i_d'>'][<_m_a_s_k>|'*']]*
where <_c_l_a_s_s> defines a class of events and is one of:
JJ for job-related events,
SS for fax send-related events,
RR for fax receive-related events, and
MM for modem-related events.
A <_m_a_s_k> is a 4-hex-digit mask of trigger events (see the
table below). If ``*'' is specified then all events in
the class are matched.
An <_i_d> can be used to restrict matches to a specific job
or modem. Eventually this will need to be generalized for
job groups.
Thus an example specification that would catch any event
for the modem on ttyf2 would be ``M<ttyf2>*'', and to be
notified when job 1932 is requeued or completes one would
use ``J<1932>4c60''.
The output from _f_a_x_w_a_t_c_h is ASCII text that describes each
event. _f_a_x_w_a_t_c_h runs until it is interrupted.
OOPPTTIIOONNSS
--gg Display times and dates in Greenwich Mean Time
(GMT). NB: _t_h_i_s _i_s _t_h_e _d_e_f_a_u_l_t.
--hh _h_o_s_t Report the status of the server on a specific
_h_o_s_t. The _h_o_s_t may be either a symbolic name or
a network address. If no --hh option is supplied,
_f_a_x_w_a_t_c_h uses the FAXSERVER environment variable
to identify the _H_y_l_a_F_A_X server to contact. If
this variable is not set, then _f_a_x_w_a_t_c_h checks
for a setting in the configuration files (first
in the per-user file and then in the system-wide
file). If all of the above fails, then _f_a_x_w_a_t_c_h
attempts to contact a server on the machine
where it is run.
--ll Display times and dates in the local timezone of
the server.
--vv Trace the protocol exchanges between _f_a_x_w_a_t_c_h
and the _h_f_a_x_d processes on the standard output.
EEVVEENNTTSS
The following table specifies the current set of events
that may be monitored. This information is subject to
change; consult the source code for reference.
EEvveenntt CCllaassss MMaasskk DDeessccrriippttiioonn
JOB_CREATE J 0x0001 job created
JOB_SUSPEND J 0x0002 job suspended
JOB_READY J 0x0004 job ready to send
JOB_SLEEP J 0x0008 job sleeping awaiting time-to-send
JOB_DEAD J 0x0010 job marked dead
JOB_PROCESS J 0x0020 job processed by scheduler
JOB_REAP J 0x0040 job corpus reaped
JOB_ACTIVE J 0x0080 job activated
JOB_REJECT J 0x0100 job rejected
JOB_KILL J 0x0200 job killed
JOB_BLOCKED J 0x0400 job blocked by other job
JOB_DELAYED J 0x0800 job delayed by tod restriction or similar
JOB_ALTERED J 0x1000 job parameters altered
JOB_TIMEDOUT J 0x2000 job kill timer expired
JOB_PREP_BEGIN J 0x4000 job preparation started
JOB_PREP_END J 0x8000 job preparation finished
SEND_BEGIN S 0x0001 fax, send attempt started
SEND_CALL S 0x0002 fax, call placed
SEND_CONNECTED S 0x0004 fax, call answered by fax
SEND_PAGE S 0x0008 fax, page transmit done
SEND_DOC S 0x0010 fax, document transmit done
SEND_POLLRCVD S 0x0020 fax, document retrieved by poll operation
SEND_POLLDONE S 0x0040 fax, poll operation completed
SEND_END S 0x0080 fax, send attempt finished
SEND_REFORMAT S 0x0100 fax, job being reformatted
SEND_REQUEUE S 0x0200 fax, job requeued
SEND_DONE S 0x0400 fax, send job done
RECV_BEGIN R 0x0001 fax, inbound call started
RECV_START R 0x0002 fax, session started
RECV_PAGE R 0x0004 fax, page receive done
RECV_DOC R 0x0008 fax, document receive done
RECV_END R 0x0010 fax, inbound call finished
MODEM_ASSIGN M 0x0001 modem assigned to job
MODEM_RELEASE M 0x0002 modem released by job
MODEM_DOWN M 0x0004 modem marked down
MODEM_READY M 0x0008 modem marked ready
MODEM_BUSY M 0x0010 modem marked busy
MODEM_WEDGED M 0x0020 modem considered wedged
MODEM_INUSE M 0x0040 modem inuse for outbound work
MODEM_DATA_BEGIN M 0x0080 inbound data call begun
MODEM_DATA_END M 0x0100 inbound data call finished
MODEM_VOICE_BEGIN M 0x0200 inbound voice call begun
MODEM_VOICE_END M 0x0400 inbound voice call finished
MODEM_CID M 0x0800 inbound caller-ID information
Event to be removed soon.
SSEEEE AALLSSOO
_h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}), _h_f_a_x_d(${MANNUM1_8}).
January 18, 1996 FAXWATCH(${MANNUM1_8})